If-None-Match header

Der HTTP-If-None-Match-Anfrage-Header macht eine Anfrage konditional. Der Server gibt die angeforderte Ressource in den Methoden GET und HEAD mit einem 200-Status nur dann zurück, wenn er kein ETag hat, das mit dem im If-None-Match-Header angegebenen Wert übereinstimmt. Für andere Methoden wird die Anfrage nur verarbeitet, wenn das gegebenenfalls existierende Ressource-ETag mit keinem der aufgelisteten Werte übereinstimmt.

Wenn die Bedingung für die Methoden GET und HEAD fehlschlägt, muss der Server einen 304 Not Modified zurückgeben und eines der folgenden Header-Felder, die in einer 200-Antwort auf dieselbe Anfrage gesendet worden wären: Cache-Control, Content-Location, Date, ETag, Expires, und Vary. Für Methoden, die serverseitige Änderungen anwenden, wird der 412 Precondition Failed verwendet, wenn die Bedingung fehlschlägt.

Der Vergleich mit dem gespeicherten ETag verwendet den schwachen Vergleichsalgorithmus, was bedeutet, dass zwei Dateien als identisch betrachtet werden, wenn der Inhalt gleichwertig ist — sie müssen nicht byteweise identisch sein. Zum Beispiel würden zwei Seiten, die sich nur durch ihr Erstellungsdatum im Footer unterscheiden, trotzdem als identisch angesehen werden.

In Kombination mit If-Modified-Since hat If-None-Match Vorrang, wenn der Server es unterstützt.

Es gibt zwei häufige Fälle für die Verwendung von If-None-Match in Anfragen:

• Für die Methoden GET und HEAD, um eine zwischengespeicherte Entität zu aktualisieren, die mit einem ETag verbunden ist.
• Für andere Methoden, insbesondere für PUT, kann If-None-Match mit dem *-Wert verwendet werden, um eine Datei nur dann zu speichern, wenn sie noch nicht existiert, was garantiert, dass das Hochladen nicht versehentlich ein anderes Hochladen überschreibt und die Daten des vorherigen PUT verliert; dieses Problem ist eine Variante des Versionsverwaltungsproblems.